home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir34 / tarshell.zip / TARSHELL.DOC < prev    next >
Text File  |  1994-01-13  |  52KB  |  1,187 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                            The TAR Shell Program
  14.  
  15.                                  TARSHELL
  16.  
  17.  
  18.                                  Vers. 1.0
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. Timothy W. Saffell
  40. 4203 Enterprise Rd.
  41. Bowie, Maryland 20720 USA
  42.  
  43. saffell@mail.loc.gov
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                              Table of Contents
  52.  
  53.  
  54.  
  55. INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  56.  
  57. WARRANTY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  58.  
  59. INSTALLATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  60.  
  61. EXECUTING TARSHELL. . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  62.  
  63. THE CONFIGURATION FILE. . . . . . . . . . . . . . . . . . . . . . . . .   6
  64.  
  65. EXITING TARSHELL. . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  66.  
  67. 1.  CONFIGURE TARSHELL. . . . . . . . . . . . . . . . . . . . . . . . .   7
  68.   1.1.  PATH TO TAR.EXE AND TAPE.EXE. . . . . . . . . . . . . . . . . .   7
  69.   1.2.  PATH TO YOUR EDITOR . . . . . . . . . . . . . . . . . . . . . .   7
  70.   1.3.  CONFIGURATION FILE NAME . . . . . . . . . . . . . . . . . . . .   8
  71.   1.4.  TAPE FORMAT OPTIONS . . . . . . . . . . . . . . . . . . . . . .   8
  72.     1.4.1.  TAPE BLOCKSIZE. . . . . . . . . . . . . . . . . . . . . . .   8
  73.     1.4.2.  BLOCKING FACTOR FOR TAPE ARCHIVE (-b) . . . . . . . . . . .   8
  74.     1.4.3.  COMPRESS ARCHIVE (-z) . . . . . . . . . . . . . . . . . . .   8
  75.     1.4.4.  PRESERVE ABSOLUTE PATHS (-P). . . . . . . . . . . . . . . .   9
  76.     1.4.5.  INCLUDE EAs, HIDDEN, and SYSTEM FILES (-p). . . . . . . . .   9
  77.     1.4.6.  SAVE CREATED/ACCESSED TIME STAMPS? (-pp). . . . . . . . . .   9
  78.     1.4.7.  ALLOW MULTIVOLUME ARCHIVES (-M) . . . . . . . . . . . . . .   9
  79.     1.4.8.  CREATE/MAINTAIN A TAPE DIRECTORY (-D) . . . . . . . . . . .   9
  80.     1.4.9.  TAPE DIRECTORY FILE NAME. . . . . . . . . . . . . . . . . .   9
  81.   1.5.  PROGRESS REPORTING OPTIONS. . . . . . . . . . . . . . . . . . .  10
  82.     1.5.1.  LEVEL OF PROGRESS REPORTING (-v, -E). . . . . . . . . . . .  10
  83.     1.5.2.  PRINT RECORD NUMBERS (-R) . . . . . . . . . . . . . . . . .  10
  84.   1.6.  BACKUP OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . .  10
  85.     1.6.1.  BACKUP PROCEDURE. . . . . . . . . . . . . . . . . . . . . .  10
  86.       1.6.1.1.  BASED ON DATE: FIRST, INCREMENTAL, (...). . . . . . . .  11
  87.       1.6.1.2.  BASED ON DATE:  FIRST, SECOND, (...). . . . . . . . . .  11
  88.       1.6.1.3.  BASED ON ARCHIVE BIT:  FIRST, INCREMENTAL, (...). . . .  11
  89.       1.6.1.4.  BASED ON ARCHIVE BIT:  FIRST, SECOND, (...) . . . . . .  12
  90.     1.6.2.  DUMP FILE NAME (-g) . . . . . . . . . . . . . . . . . . . .  12
  91.  
  92. 2.  Set TARSHELL Mode . . . . . . . . . . . . . . . . . . . . . . . . .  12
  93.  
  94. 3.  CREATE A TAPE ARCHIVE (-c). . . . . . . . . . . . . . . . . . . . .  12
  95.   3.1.  FILE SPECIFICATION. . . . . . . . . . . . . . . . . . . . . . .  12
  96.   3.2.  INCLUDE ONLY CERTAIN FILES (-T) . . . . . . . . . . . . . . . .  13
  97.   3.3.  FILES TO PROCESS ARE IN . . . . . . . . . . . . . . . . . . . .  13
  98.   3.4.  EXCLUDE CERTAIN FILES (-X). . . . . . . . . . . . . . . . . . .  13
  99.   3.5.  FILES TO EXCLUDE ARE IN . . . . . . . . . . . . . . . . . . . .  13
  100. TARSHELL:  The TAR Shell Program, v. 1.0                                 3
  101.  
  102.  
  103. 3.6.  PROCESS SUBDIRECTORIES (-Y)  14
  104.   3.7.  GENERATION TYPE . . . . . . . . . . . . . . . . . . . . . . . .  14
  105.   3.8.  CONTINUE WITH CREATE FUNCTION . . . . . . . . . . . . . . . . .  14
  106.  
  107. 4.  LIST THE TABLE OF CONTENTS OF A TAPE ARCHIVE (-t) . . . . . . . . .  14
  108.   4.1.  FILE SPECIFICATION. . . . . . . . . . . . . . . . . . . . . . .  15
  109.   4.2.  INCLUDE ONLY CERTAIN FILES (-T) . . . . . . . . . . . . . . . .  15
  110.   4.3.  FILES TO PROCESS ARE IN . . . . . . . . . . . . . . . . . . . .  15
  111.   4.4.  EXCLUDE CERTAIN FILES (-X). . . . . . . . . . . . . . . . . . .  15
  112.   4.5.  FILES TO EXCLUDE ARE IN . . . . . . . . . . . . . . . . . . . .  16
  113.   4.6.  PROGRESS REPORTING OPTIONS. . . . . . . . . . . . . . . . . . .  16
  114.     4.6.1.  LEVEL OF PROGRESS REPORTING (-v, -E). . . . . . . . . . . .  16
  115.     4.6.2.  PRINT RECORD NUMBERS (-R) . . . . . . . . . . . . . . . . .  16
  116.   4.7.  CONTINUE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  117.  
  118. 5.  COMPARE FILES IN A TAPE ARCHIVE. (-d) . . . . . . . . . . . . . . .  17
  119.   5.1.  FILE SPECIFICATION. . . . . . . . . . . . . . . . . . . . . . .  17
  120.   5.2.  INCLUDE ONLY CERTAIN FILES (-T) . . . . . . . . . . . . . . . .  17
  121.   5.3.  FILES TO PROCESS ARE IN . . . . . . . . . . . . . . . . . . . .  17
  122.   5.4.  EXCLUDE CERTAIN FILES (-X). . . . . . . . . . . . . . . . . . .  17
  123.   5.5.  FILES TO EXCLUDE ARE IN . . . . . . . . . . . . . . . . . . . .  18
  124.   5.6.  PROGRESS REPORTING OPTIONS. . . . . . . . . . . . . . . . . . .  18
  125.     5.6.1.  LEVEL OF PROGRESS REPORTING (-v, -E). . . . . . . . . . . .  18
  126.     5.6.2.  PRINT RECORD NUMBERS (-R) . . . . . . . . . . . . . . . . .  18
  127.   5.7.  CONTINUE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  128.  
  129. 6.  EXTRACT FROM A TAPE ARCHIVE--RANDOM (QFA) (-x -D) . . . . . . . . .  19
  130.   6.1.  FILE SPECIFICATION. . . . . . . . . . . . . . . . . . . . . . .  19
  131.   6.2.  INCLUDE ONLY CERTAIN FILES (-T) . . . . . . . . . . . . . . . .  19
  132.   6.3.  FILES TO PROCESS ARE IN . . . . . . . . . . . . . . . . . . . .  19
  133.   6.4.  EXCLUDE CERTAIN FILES (-X). . . . . . . . . . . . . . . . . . .  19
  134.   6.5.  FILES TO EXCLUDE ARE IN . . . . . . . . . . . . . . . . . . . .  20
  135.   6.6.  PROCESS SUBDIRECTORIES (-Y) . . . . . . . . . . . . . . . . . .  20
  136.   6.7.  ABSOLUTE PATH/REDIRECTION (-P). . . . . . . . . . . . . . . . .  20
  137.   6.8.  PROGRESS REPORTING OPTIONS. . . . . . . . . . . . . . . . . . .  20
  138.     6.8.1.  LEVEL OF PROGRESS REPORTING (-v, -E). . . . . . . . . . . .  20
  139.     6.8.2.  PRINT RECORD NUMBERS (-R) . . . . . . . . . . . . . . . . .  20
  140.   6.9.  CONTINUE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  141.  
  142. 7.  EXTRACT FROM A TAPE ARCHIVE--SEQUENTIAL (-x). . . . . . . . . . . .  21
  143.   7.2.  INCLUDE ONLY CERTAIN FILES (-T) . . . . . . . . . . . . . . . .  21
  144.   7.3.  FILES TO PROCESS ARE IN . . . . . . . . . . . . . . . . . . . .  21
  145.   7.4.  EXCLUDE CERTAIN FILES (-X). . . . . . . . . . . . . . . . . . .  22
  146.   7.5.  FILES TO EXCLUDE ARE IN . . . . . . . . . . . . . . . . . . . .  22
  147.   7.6.  PROCESS SUBDIRECTORIES (-Y) . . . . . . . . . . . . . . . . . .  22
  148.   7.7.  ABSOLUTE PATH/REDIRECTION (-P). . . . . . . . . . . . . . . . .  22
  149.   7.8.  PROGRESS REPORTING OPTIONS. . . . . . . . . . . . . . . . . . .  22
  150.     7.8.1.  LEVEL OF PROGRESS REPORTING (-v, -E). . . . . . . . . . . .  22
  151.     7.8.2.  PRINT RECORD NUMBERS (-R) . . . . . . . . . . . . . . . . .  23
  152.   7.9.  CONTINUE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  153. TARSHELL:  The TAR Shell Program, v. 1.0                                 4
  154.  
  155.  
  156. 8.  TAPE UTILITY FUNCTIONS  . . . . . . . . . . . . . . . . . . . . . .  23
  157.   8.1.  RETENTION TAPE. . . . . . . . . . . . . . . . . . . . . . . . .  23
  158.   8.2.  REWIND TAPE . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  159.   8.3.  ERASE TAPE. . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  160.   8.4.  POSITION TAPE BY FILE MARK. . . . . . . . . . . . . . . . . . .  23
  161.   8.5.  POSITION TAPE BY BLOCK. . . . . . . . . . . . . . . . . . . . .  24
  162.   8.6.  POSITION TAPE TO END OF DATA. . . . . . . . . . . . . . . . . .  24
  163.   8.7.  TELL CURRENT TAPE POSITION. . . . . . . . . . . . . . . . . . .  24
  164.   8.8.  WRITE A TAPE MARK . . . . . . . . . . . . . . . . . . . . . . .  24
  165.  
  166.  
  167.  
  168.  
  169. INTRODUCTION
  170.  
  171. TARSHELL is a program which was written to make it easier to use the GNU
  172. TAR (Tape Archive) port to OS/2 by Andreas Kaiser, namely GTAK.  TARSHELL
  173. does not require Presentation Manager, so it can be executed from a floppy
  174. disk.
  175.  
  176. TARSHELL does not process disk or tape files.  It merely provides a menu of
  177. choices and executes TAR.EXE with the appropriate combination of options. 
  178. Every possible attempt has been made to allow you to see the results passed
  179. back from TAR.EXE or TAPE.EXE.  When TARSHELL executes TAR or TAPE, it
  180. first clears the screen.  Before continuing, TARSHELL pauses to allow you
  181. to see the output from the TAR or TAPE program.
  182.  
  183. TARSHELL has been kept as small as possible so that it can be executed from
  184. a floppy disk.  There are no pop-up context-sensitive help screens and
  185. there is only minimal editing of your entries.  
  186.  
  187.  
  188. WARRANTY
  189.  
  190. None.  You are responsible to test TARSHELL with GTAK on your system to be
  191. sure that it works before depending on it.  If you use TARSHELL, you do so
  192. at your own risk.
  193.  
  194.  
  195. INSTALLATION
  196.  
  197. Assuming that you have a SCSI Host Adapter with a SCSI Tape Backup Unit
  198. supported by OS/2, in addition to TARSHELL, you will need GTAKxxx (the
  199. latest one at the time that this was written is GTAK212).  I would suggest
  200. that you also get a copy of MAKEBOOT while you are at it.
  201.  
  202. Create a new subdirectory on your hard disk and unzip GTAK into it. 
  203. Determine from the GTAK documentation which of the drivers you need to use
  204. for your SCSI Adapter/Tape Drive combination and install them in your
  205. CONFIG.SYS.  Be sure that GTAK is working before trying to use TARSHELL. 
  206. If you enter "TAPE LOAD", the first time (ONLY the first time since power
  207. has been applied to your SCSI host adapter) you will get several lines of
  208. feedback.  If that seems to work, put a tape into the drive and enter "TAPE
  209. ERASE".  The tape should whrrr for several minutes.
  210.  
  211. With GTAK installed and working, you can install TARSHELL.  TARSHELL can be
  212. placed into the same subdirectory in which you have GTAK or it can be
  213. placed in another subdirectory of its own.
  214.  
  215. When you are confident that the GTAK and TARSHELL programs are working well
  216. together, create a boot disk and install SCSI support, GTAK and TARSHELL on
  217. floppy disks.  Your backup system will not do you much good if it is only
  218. installed on a hard disk and that hard disk just went south.
  219.  
  220. TARSHELL:  The TAR Shell Program, v. 1.0                                 6
  221.  
  222.  
  223. If you have two floppy drives, it's most convenient to install GTAK and
  224. TARSHELL on the disk size that fits into your b: drive.  Otherwise, just
  225. swap the boot disk for the disk with the backup software on it in your a:
  226. drive.
  227.  
  228.  
  229. EXECUTING TARSHELL
  230.  
  231. First of all, change the current directory to the drive and directory in
  232. which you have installed TARSHELL.  Then enter the program name "TARSHELL". 
  233. For this first time, TARSHELL will ask you where you have installed GTAK. 
  234. Enter the complete path of the subdirectory in which you have placed the
  235. GTAK programs, TAR.EXE and TAPE.EXE.
  236.  
  237. After starting TARSHELL and entering the path to the GTAK programs, you
  238. should see the screen go blank.  TAR should display its version number, the
  239. output from the TAPE LOAD command should be displayed on the screen and
  240. then "Press a key to continue" should be displayed on the bottom line of
  241. the screen.
  242.  
  243.   DIAGNOSTIC:  If you see only a blank screen except for the bottom line,
  244.     TARSHELL was not able to find TAR.EXE and TAPE.EXE in the location
  245.     that you just entered.  Continue with the configuration process and
  246.     correct the entry for the location of TAR.EXE and TAPE.EXE as
  247.     described below.
  248.  
  249. If you will read through the rest of this document while looking at the
  250. menus that TARSHELL presents to you, you will probably feel quite at home
  251. with TARSHELL by the time you get finished.
  252.  
  253. This manual is organized to correspond to the menu options that are
  254. available in TARSHELL.  The numbers on the paragraphs correspond to the
  255. choices that you must make from TARSHELL's main menu in order to perform
  256. the operation described in the paragraph.  Since it is organized in this
  257. manner, some of the material is redundant.  In the case where an option is
  258. available at more than one place in TARSHELL, the explanation of the option
  259. is repeated.  I felt that it was better to have redundant information than
  260. to send you searching all over the manual to find an explanation.
  261.  
  262.  
  263. THE CONFIGURATION FILE
  264.  
  265. TARSHELL will accept one command line argument, the name of the
  266. configuration file.  The first time you execute TARSHELL, you don't have to
  267. enter the name of a configuration file.  TARSHELL will use the default
  268. name, TARSHELL.CFG.  If the file doesn't exist (probably it won't), it will
  269. be created.  The configuration file is the file in which TARSHELL keeps
  270. configuration information about your environment and your preferences for
  271. executing GTAK.  Generally you will only need one configuration file,
  272. although there are exceptions to this rule that are described below.  If
  273. TARSHELL:  The TAR Shell Program, v. 1.0                                 7
  274.  
  275.  
  276. you only have one configuration file, you never need to enter its name,
  277. since TARSHELL will always use the default name, TARSHELL.CFG.
  278.  
  279. Now why would you want to have more than one configuration file?  Let's
  280. suppose that you have a regular backup routine in place, you've set up the
  281. parameters in TARSHELL.CFG so that it works the way you want it to.  But
  282. periodically, you must send the contents of several directories to someone
  283. else on tape.  You could set up a second configuration file with a
  284. different name for the dump file, and the directory file, and a different
  285. file specification so that just the desired files would be copied to tape,
  286. but your regular routine would not be disturbed.
  287.  
  288.  
  289. EXITING TARSHELL
  290.  
  291. When you have finished using TARSHELL, you must return to the main menu to
  292. exit.  This can be done from anywhere in the program by pressing the "0"
  293. zero choice on each menu until you return to the main menu.  When you press
  294. "0" zero on the main menu, TARSHELL will ask you if you want to UNLOAD the
  295. tape.  This might take a while, and may accomplish little, depending on the
  296. device, so you may choose not to UNLOAD the tape.  Generally, if you UNLOAD
  297. the tape, it will be rewound to the beginning and if your device has an
  298. LED, it will be turned off.
  299.  
  300.  
  301. 1.  CONFIGURE TARSHELL
  302.  
  303. This is where you give TARSHELL some guidelines.  You should look over the
  304. default options, at least.  Many of them will be OK without change, but you
  305. might need to make some changes for your specific environment.  As a
  306. general rule, you will not need to change the configuration once it is set.
  307.  
  308. 1.1.  PATH TO TAR.EXE AND TAPE.EXE
  309.  
  310. Enter the path in which TARSHELL will find the GTAK programs TAR.EXE and
  311. TAPE.EXE.
  312.  
  313. Enter the drive and directory, for example, "C:\GTAK212\".
  314.  
  315. 1.2.  PATH TO YOUR EDITOR
  316.  
  317. Enter the fully qualified name of your editor.  If you want to use either
  318. the "include only certain files" or the "exclude certain files" options,
  319. TARSHELL will give you the opportunity to edit the text files which contain
  320. these lists of file names.  If you want to do this from a floppy disk, you
  321. should be sure that your editor does not require that the presentation
  322. manager be loaded, that is, it should be a text-mode editor.
  323.  
  324. Enter the drive, path, and complete program name, for example,
  325. "C:\WE12\WE.EXE".
  326. TARSHELL:  The TAR Shell Program, v. 1.0                                 8
  327.  
  328.  
  329. 1.3.  CONFIGURATION FILE NAME
  330.  
  331. TARSHELL saves the configuration parameters in a file, by default, TARSHELL
  332. will use the name TARSHELL.CFG.  This way, you will only need to set the
  333. configuration parameters once and TARSHELL will remember them by reading
  334. them back from the file the next time you run the program.
  335.  
  336. If you ask to change the name of the configuration file, TARSHELL will look
  337. for a file with the name that you enter.  If the file exists, the
  338. parameters will be read in from the file and used for subsequent
  339. operations.  If you change any processing parameters, TARSHELL will write
  340. the changes back to the new file.
  341.  
  342. If you enter the name of a file that does not exist, the parameters that
  343. are currently in use will continue to be in use.  If you change any
  344. configuration parameters, TARSHELL will write the changes to the new file.
  345.  
  346. 1.4.  TAPE FORMAT OPTIONS
  347.  
  348. The options on this menu control what and how data is written on the tape
  349. archive.
  350.  
  351. 1.4.1.  TAPE BLOCKSIZE
  352.  
  353. The tape blocksize is hardware dependent and should not be confused with
  354. the software blocking factor which may be entered below.  Some tape devices
  355. give you the option of using a hardware blocksize of 512 or 1024 bytes.  If
  356. your device is capable of different blocksizes, you may specify your choice
  357. here.
  358.  
  359. 1.4.2.  BLOCKING FACTOR FOR TAPE ARCHIVE (-b)
  360.  
  361. You can enter a number here to tell TAR how to block records on the tape
  362. archive.  If you enter zero, TARSHELL will indicate to TAR that it should
  363. use its own default, currently blocking at a factor of 20, with 512 bytes
  364. per record, and 10K bytes per block.
  365.  
  366. 1.4.3.  COMPRESS ARCHIVE (-z)
  367.  
  368. If set to YES, data on the tape archive will be compressed.  There are pros
  369. and cons to using this option.  Obviously, if the tape archive is
  370. compressed, more data will fit on a given tape.  Not so obviously, though,
  371. if a tape archive is damaged, it is impossible to recover data after the
  372. spot on the tape where the damage occurred, whereas, if the tape archive is
  373. not compressed, it is possible to skip over the damaged spot on the tape
  374. and continue to process the data, minimizing the loss.
  375.  
  376. TARSHELL:  The TAR Shell Program, v. 1.0                                 9
  377.  
  378.  
  379. 1.4.4.  PRESERVE ABSOLUTE PATHS (-P)
  380.  
  381. If this option is set to YES, TAR will include the "drive:" in the name of
  382. the file as it places it on the tape archive.  Otherwise TAR removes the
  383. "drive:" part of the file name.  If you will be archiving files from more
  384. than one disk drive, say C: and D:, onto the same archive tape, there might
  385. be some confusion if the files do not have their absolute paths.  Even
  386. files with absolute paths can be redirected to another drive or directory
  387. when they are restored.
  388.  
  389. 1.4.5.  INCLUDE EAs, HIDDEN, and SYSTEM FILES (-p)
  390.  
  391. If set to YES, TAR will include the Extended Attributes of each file in the
  392. tape archive.  Also hidden and system files will be included ... just like
  393. it says.
  394.  
  395. 1.4.6.  SAVE CREATED/ACCESSED TIME STAMPS? (-pp)
  396.  
  397. If set to YES, TAR will preserve information that indicates when each file
  398. was created and last accessed.
  399.  
  400. 1.4.7.  ALLOW MULTIVOLUME ARCHIVES (-M)
  401.  
  402. If set to YES, when TAR reaches the end of a tape volume (cartridge), TAR
  403. will ask you to insert another tape.  TAR will then continue processing on
  404. the next tape.
  405.  
  406. 1.4.8.  CREATE/MAINTAIN A TAPE DIRECTORY (-D)
  407.  
  408. If set to YES, TAR will keep a directory of files that it writes to tape. 
  409. This directory has information that allows TAR to go directly to a file on
  410. the tape.  This is known as Quick File Access (QFA).  QFA must be available
  411. on the hardware that you have installed for this to work.
  412.  
  413. 1.4.9.  TAPE DIRECTORY FILE NAME
  414.  
  415. This option allows you to enter the name of the file in which you want TAR
  416. to store the directory information for QFA.  Generally, you should not need
  417. to change this name.  The same file should be used for all processes on a
  418. tape.  Even if you backup more than one disk drive to the tape, you should
  419. use the same directory file for the tape.
  420.  
  421. When you create a new tape, TARSHELL will ask you if you want to delete
  422. this file so TAR can create a new one.  Generally you should.  Then when
  423. you create any additional archives on the tape, you should continue to use
  424. the same directory file, so that it can be updated to reflect the files
  425. that are being added to the tape.
  426.  
  427. Where should you put the directory file?  This file can get very large, and
  428. might not fit on the floppy disk with GTAK and TARSHELL.  But, if you have
  429. TARSHELL:  The TAR Shell Program, v. 1.0                                10
  430.  
  431.  
  432. a hard disk failure, you might not be able to have access to the directory
  433. if it was placed on the hard disk that failed.  On the other hand, if you
  434. have a major crash, you will be doing massive restores of whole archives
  435. and you don't need QFA for that.  Go ahead and put it on your hard disk
  436. where there will be plenty of room.
  437.  
  438. Additionally, you might want to create an archive on the tape which
  439. contains only the tape directory file.  This file could be copied to tape
  440. after the hard disk backup is completed.
  441.  
  442. 1.5.  PROGRESS REPORTING OPTIONS
  443.  
  444. Progress reporting options will keep you informed of the progress that TAR
  445. is making.  Keep in mind that a lot of data being written on the monitor
  446. will slow down the operation.  You might want to compromise between
  447. informative and efficient operation.
  448.  
  449. 1.5.1.  LEVEL OF PROGRESS REPORTING (-v, -E)
  450.  
  451. There are three levels of progress reporting.  1) TAR will inform you of
  452. every file that it processes, 2) TAR will inform you as it processes each
  453. directory, 3) TAR will not tell you anything.  You might want to choose the
  454. first option while you are installing and testing TAR and TARSHELL, then
  455. move to the second option.  If you have lots of confidence, you can then
  456. move to the third option.
  457.  
  458. 1.5.2.  PRINT RECORD NUMBERS (-R)
  459.  
  460. If set to YES, TAR will print out the record number corresponding to the
  461. beginning of each file on the tape.  This option can be very useful if you
  462. are trying to process a tape that has been damaged.  Note that this option
  463. does not take into consideration the setting of progress reporting above,
  464. so if you request record numbers and progress reporting by directory, you
  465. will see a directory name followed by a string of record numbers (one for
  466. each file), but without the file names that the record numbers correspond
  467. to.
  468.  
  469. 1.6.  BACKUP OPTIONS
  470.  
  471. This is where you indicate the basic philosophy of the backup procedure
  472. that you desire.  One of these should be selected before creating a new
  473. tape and the same procedure should remain in effect for the use of the
  474. tape.
  475.  
  476. 1.6.1.  BACKUP PROCEDURE
  477.  
  478. This is where you specify which of the backup procedures you wish to have
  479. performed.  You should select one of these methods and continue to use it
  480. unless you have a good reason to switch to another method.  When you
  481. indicate that you wish to create a tape archive, you will be asked whether
  482. TARSHELL:  The TAR Shell Program, v. 1.0                                11
  483.  
  484.  
  485. you want to do a first, second, or incremental backup based on the
  486. selection that you make here.
  487.  
  488. 1.6.1.1.  BASED ON DATE: FIRST, INCREMENTAL, (...)
  489.  
  490. The first time you use this procedure, all files from the disk are archived
  491. to tape.  The date on which this takes place is written on the dump file.
  492.  
  493. The next and all subsequent backups are incremental archives.  The date of
  494. the last modification of each file is compared to the date on the dump file
  495. and any file that has been modified since the date on the dump file is
  496. archived to tape.  The dump file is modified with the date on which this
  497. takes place.  The same procedure is followed for all subsequent backups.
  498.  
  499. In order to perform a complete restore from tape with this procedure, you
  500. must first restore the first backup, then each and every incremental backup
  501. in the order in which they were taken.
  502.  
  503. 1.6.1.2.  BASED ON DATE:  FIRST, SECOND, (...)
  504.  
  505. The first time you use this procedure, all files from the disk are archived
  506. to tape.  The date on which this takes place is written on the dump file.
  507.  
  508. The next and all subsequent backups are second archives.  The date of
  509. modification is compared to the date on the dump file and any file that has
  510. been modified since the date of the first backup is archived to tape.  With
  511. this procedure the dump file is NOT modified with the date on which this
  512. takes place.  The same procedure is followed for all subsequent backups. 
  513. Thus, each subsequent backup will archive all files that have been modified
  514. since the first backup.
  515.  
  516. In order to perform a complete restore from tape with this procedure, you
  517. must first restore the first backup, then only the latest second backup. 
  518. There is no need to restore any of the intermediate second backups.
  519.  
  520. 1.6.1.3.  BASED ON ARCHIVE BIT:  FIRST, INCREMENTAL, (...)
  521.  
  522. The first time you use this procedure, all files from the disk are archived
  523. to tape.  The archive attribute of each file is reset (turned OFF).
  524.  
  525. On the second and all subsequent uses of this procedure, TAR will archive
  526. only those files whose archive bit has been set (turned ON).  The archive
  527. bit associated with a file is turned on automatically by the operating
  528. system when the file is modified or copied to the hard disk.
  529.  
  530. In order to perform a complete restore from tape with this procedure, you
  531. must first restore the first backup, then each and every incremental backup
  532. in the order in which they were taken.
  533.  
  534. TARSHELL:  The TAR Shell Program, v. 1.0                                12
  535.  
  536.  
  537. 1.6.1.4.  BASED ON ARCHIVE BIT:  FIRST, SECOND, (...)
  538.  
  539. The first time you use this procedure, all files from the disk are archived
  540. to tape.  The archive attribute of each file is reset (turned OFF).
  541.  
  542. On the second and all subsequent uses of this procedure, TAR will archive
  543. only those files whose archive bit has been set (turned ON), but will NOT
  544. turn off the archive bit.
  545.  
  546. In order to perform a complete restore from tape with this procedure, you
  547. must first restore the first backup, then only the most recent second
  548. archive.  There is no need to restore any of the other second backups.
  549.  
  550. 1.6.2.  DUMP FILE NAME (-g)
  551.  
  552. The dump file is the file in which TAR keeps data about the date of the
  553. last backup.  It is required for backup procedures based on date.  It is
  554. written to during first and incremental backups.
  555.  
  556.  
  557. 2.  Set TARSHELL Mode
  558.  
  559. TARSHELL operates in two modes.  This choice toggles between the two modes. 
  560. By default, TARSHELL is in EXECUTE PROGRAM mode.  As you make choices from
  561. the TARSHELL menus, TARSHELL will call TAR and TAPE to perform the
  562. functions that you have requested.  If you toggle the mode to GENERATE .CMD
  563. FILE, rather than calling TAR and TAPE programs, TARSHELL will write the
  564. commands into a .CMD file.  You can execute the command file whenever you
  565. please.  One advantage of executing a command file over executing the
  566. programs dynamically, is that you do not have to be present to interact
  567. with TARSHELL.
  568.  
  569. If you make an entry like "FULLBACK.CMD", a file named FULLBACK.CMD will be
  570. written in the current directory.  If you enter something like
  571. "C:\CMDFILES\FULLBACK.CMD" the output will be written into the specified
  572. directory.  If you enter "FULLBACK", a file named FULLBACK will be written
  573. in the current directory, but you will have to rename it with an extension
  574. of .CMD before you can execute it as a .CMD file.
  575.  
  576.  
  577. 3.  CREATE A TAPE ARCHIVE (-c)
  578.  
  579. This option causes TAR to copy a set of files to tape, creating a new tape
  580. archive.
  581.  
  582. 3.1.  FILE SPECIFICATION
  583.  
  584. The file specification tells TAR which files to process.  For example,
  585. "C:\" along with PROCESS SUBDIRECTORIES below set to YES, will process your
  586. TARSHELL:  The TAR Shell Program, v. 1.0                                13
  587.  
  588.  
  589. entire C: drive.  Similarly "C:\ D:\" will process both the C: and D:
  590. drives.
  591.  
  592. Please note:  If you specify "process only certain files" below, the file
  593. specification that you enter here will be ignored.
  594.  
  595. 3.2.  INCLUDE ONLY CERTAIN FILES (-T)
  596.  
  597. If you want to process only selected files, you may place the names of the
  598. files that you wish to process in a text file.  Only the files whose names
  599. are in the text file will be processed.
  600.  
  601. Please note:  If you specify "process only certain files" here, the file
  602. specification that you enter above will be ignored.
  603.  
  604. Also note that filenames are case sensitive and must be specified exactly
  605. as they appear in a table of contents listing.
  606.  
  607. 3.3.  FILES TO PROCESS ARE IN
  608.  
  609. This option is used in conjunction with the one above.  If you set "process
  610. only certain files" to "yes", you must provide a list of the files that you
  611. want to process.
  612.  
  613. When you select this option from the menu, you can enter the name of the
  614. file that contains the list of files that you want to process.  If you have
  615. entered the name of an editor in the configuration section above, TARSHELL
  616. will give you the opportunity to start the editor with the file that you
  617. specify so that you can enter or modify the list of filenames.
  618.  
  619. Filenames should be listed one per line. They may contain wildcards.  Also
  620. note that filenames are case sensitive and must be specified exactly as
  621. they appear in a table of contents listing.
  622.  
  623. 3.4.  EXCLUDE CERTAIN FILES (-X)
  624.  
  625. If you want to exclude certain files from processing, you may place the
  626. names of the files that you wish to exclude in a text file.
  627.  
  628. This option may be used with either the "file specification" or the
  629. "include only certain files" in effect.
  630.  
  631. Note that filenames are case sensitive and must be specified exactly as
  632. they appear in a table of contents listing.
  633.  
  634. 3.5.  FILES TO EXCLUDE ARE IN
  635.  
  636. This option is used in conjunction with the one above.  If you set "exclude
  637. certain files" to "yes", you must provide a list of the files that you want
  638. to exclude.
  639. TARSHELL:  The TAR Shell Program, v. 1.0                                14
  640.  
  641.  
  642. When you select this option from the menu, you can enter the name of the
  643. file that contains the list of files that you want to exclude from
  644. processing.  If you have entered the name of an editor in the configuration
  645. section above, TARSHELL will give you the opportunity to start the editor
  646. with the file that you specify so that you can enter or modify the list of
  647. filenames.
  648.  
  649. Filenames should be listed one per line. They may contain wildcards.  Note
  650. that filenames are case sensitive and must be specified exactly as they
  651. appear in a table of contents listing.
  652.  
  653. 3.6.  PROCESS SUBDIRECTORIES (-Y)
  654.  
  655. Set this option to YES and TAR will process files in the subdirectories
  656. under the location that you specify in FILE SPECIFICATION above.
  657.  
  658. 3.7.  GENERATION TYPE
  659.  
  660. You will be prompted for the type of generation that you want to produce. 
  661. If you have chosen one of the procedures that produces either a first or
  662. incremental generation, you will be given those two options to choose from. 
  663. If you have chosen one of the procedures that produces a first or second
  664. generation, those options will be available.
  665.  
  666. If you have selected one of the backup procedures which are based on date,
  667. you must also enter a dump file name in order for it to work.
  668.  
  669. 3.8.  CONTINUE WITH CREATE FUNCTION
  670.  
  671. When you have set the above options the way you want them to be, select
  672. this option to continue to create an archive on tape.
  673.  
  674. You will be reminded that TAR will normally append data to the end of the
  675. tape.  If you would like this file to be the first one on the tape
  676. (discarding the data that was previously on the tape), you will be given
  677. the opportunity to erase the tape first.
  678.  
  679.   DIAGNOSTIC:  If you erase the tape, TAR may (depending on the device)
  680.     display an error message when it attempts to seek the end of the
  681.     data.  This is normal.
  682.  
  683. When you erase the tape, or begin using a new one, you should also delete
  684. the directory file.  TARSHELL will ask you if you would like to delete it. 
  685. TAR will then create a new one from scratch.
  686.  
  687.  
  688. 4.  LIST THE TABLE OF CONTENTS OF A TAPE ARCHIVE (-t)
  689.  
  690. This option causes TAR to read a tape archive and list its contents.  The
  691. result is dependent on the reporting options that you have set.  You will
  692. TARSHELL:  The TAR Shell Program, v. 1.0                                15
  693.  
  694.  
  695. probably want to set TAR to report BY FILE.  You may also want to have
  696. record numbers displayed.
  697.  
  698. 4.1.  FILE SPECIFICATION
  699.  
  700. This option allows you to specify which files are to be processed.
  701.  
  702. 4.2.  INCLUDE ONLY CERTAIN FILES (-T)
  703.  
  704. If you want to process only selected files, you may place the names of the
  705. files that you wish to process in a text file.  Only the files whose names
  706. are in the text file will be processed.
  707.  
  708. Please note:  If you specify "process only certain files" here, the file
  709. specification that you enter above will be ignored.
  710.  
  711. Also note that filenames are case sensitive and must be specified exactly
  712. as they appear in a table of contents listing.
  713.  
  714. 4.3.  FILES TO PROCESS ARE IN
  715.  
  716. This option is used in conjunction with the one above.  If you set "process
  717. only certain files" to "yes", you must provide a list of the files that you
  718. want to process.
  719.  
  720. When you select this option from the menu, you can enter the name of the
  721. file that contains the list of files that you want to process.  If you have
  722. entered the name of an editor in the configuration section above, TARSHELL
  723. will give you the opportunity to start the editor with the file that you
  724. specify so that you can enter or modify the list of filenames.
  725.  
  726. Filenames should be listed one per line. They may contain wildcards.  Also
  727. note that filenames are case sensitive and must be specified exactly as
  728. they appear in a table of contents listing.
  729.  
  730. 4.4.  EXCLUDE CERTAIN FILES (-X)
  731.  
  732. If you want to exclude certain files from processing, you may place the
  733. names of the files that you wish to exclude in a text file.
  734.  
  735. This option may be used with either the "file specification" or the
  736. "include only certain files" in effect.
  737.  
  738. Note that filenames are case sensitive and must be specified exactly as
  739. they appear in a table of contents listing.
  740.  
  741. TARSHELL:  The TAR Shell Program, v. 1.0                                16
  742.  
  743.  
  744. 4.5.  FILES TO EXCLUDE ARE IN
  745.  
  746. This option is used in conjunction with the one above.  If you set "exclude
  747. certain files" to "yes", you must provide a list of the files that you want
  748. to exclude.
  749.  
  750. When you select this option from the menu, you can enter the name of the
  751. file that contains the list of files that you want to exclude from
  752. processing.  If you have entered the name of an editor in the configuration
  753. section above, TARSHELL will give you the opportunity to start the editor
  754. with the file that you specify so that you can enter or modify the list of
  755. filenames.
  756.  
  757. Filenames should be listed one per line. They may contain wildcards.  Note
  758. that filenames are case sensitive and must be specified exactly as they
  759. appear in a table of contents listing.
  760.  
  761. 4.6.  PROGRESS REPORTING OPTIONS
  762.  
  763. Progress reporting options will keep you informed of the progress that TAR
  764. is making.  Keep in mind that a lot of data being written on the monitor
  765. will slow down the operation.  You might want to compromise between
  766. informative and efficient operation.
  767.  
  768. 4.6.1.  LEVEL OF PROGRESS REPORTING (-v, -E)
  769.  
  770. There are three levels of progress reporting.  1) TAR will inform you of
  771. every file that it processes, 2) TAR will inform you as it processes each
  772. directory, 3) TAR will not tell you anything.  You might want to choose the
  773. first option while you are installing and testing TAR and TARSHELL, then
  774. move to the second option.  If you have lots of confidence, you can then
  775. move to the third option.
  776.  
  777. 4.6.2.  PRINT RECORD NUMBERS (-R)
  778.  
  779. If set to YES, TAR will print out the record number corresponding to the
  780. beginning of each file on the tape.  This option can be very useful if you
  781. are trying to process a tape that has been damaged.  Note that this option
  782. does not take into consideration the setting of progress reporting above,
  783. so if you request record numbers and progress reporting by directory, you
  784. will see a directory name followed by a string of record numbers (one for
  785. each file), but without the file names that the record numbers correspond
  786. to.
  787.  
  788. 4.7.  CONTINUE
  789.  
  790. When you have set the file specification option the way you want it, select
  791. this option to continue the process.
  792.  
  793. TARSHELL:  The TAR Shell Program, v. 1.0                                17
  794.  
  795.  
  796. 5.  COMPARE FILES IN A TAPE ARCHIVE. (-d)
  797.  
  798. This option causes TAR to read both the files on the file system and the
  799. tape archive and compare the two.  Differences in attributes, dates, sizes,
  800. and content will be reported.
  801.  
  802. 5.1.  FILE SPECIFICATION
  803.  
  804. This option allows you to specify which files are to be processed.
  805.  
  806. 5.2.  INCLUDE ONLY CERTAIN FILES (-T)
  807.  
  808. If you want to process only selected files, you may place the names of the
  809. files that you wish to process in a text file.  Only the files whose names
  810. are in the text file will be processed.
  811.  
  812. Please note:  If you specify "process only certain files" here, the file
  813. specification that you enter above will be ignored.
  814.  
  815. Also note that filenames are case sensitive and must be specified exactly
  816. as they appear in a table of contents listing.
  817.  
  818. 5.3.  FILES TO PROCESS ARE IN
  819.  
  820. This option is used in conjunction with the one above.  If you set "process
  821. only certain files" to "yes", you must provide a list of the files that you
  822. want to process.
  823.  
  824. When you select this option from the menu, you can enter the name of the
  825. file that contains the list of files that you want to process.  If you have
  826. entered the name of an editor in the configuration section above, TARSHELL
  827. will give you the opportunity to start the editor with the file that you
  828. specify so that you can enter or modify the list of filenames.
  829.  
  830. Filenames should be listed one per line. They may contain wildcards.  Also
  831. note that filenames are case sensitive and must be specified exactly as
  832. they appear in a table of contents listing.
  833.  
  834. 5.4.  EXCLUDE CERTAIN FILES (-X)
  835.  
  836. If you want to exclude certain files from processing, you may place the
  837. names of the files that you wish to exclude in a text file.
  838.  
  839. This option may be used with either the "file specification" or the
  840. "include only certain files" in effect.
  841.  
  842. Note that filenames are case sensitive and must be specified exactly as
  843. they appear in a table of contents listing.
  844.  
  845. TARSHELL:  The TAR Shell Program, v. 1.0                                18
  846.  
  847.  
  848. 5.5.  FILES TO EXCLUDE ARE IN
  849.  
  850. This option is used in conjunction with the one above.  If you set "exclude
  851. certain files" to "yes", you must provide a list of the files that you want
  852. to exclude.
  853.  
  854. When you select this option from the menu, you can enter the name of the
  855. file that contains the list of files that you want to exclude from
  856. processing.  If you have entered the name of an editor in the configuration
  857. section above, TARSHELL will give you the opportunity to start the editor
  858. with the file that you specify so that you can enter or modify the list of
  859. filenames.
  860.  
  861. Filenames should be listed one per line. They may contain wildcards.  Note
  862. that filenames are case sensitive and must be specified exactly as they
  863. appear in a table of contents listing.
  864.  
  865. 5.6.  PROGRESS REPORTING OPTIONS
  866.  
  867. Progress reporting options will keep you informed of the progress that TAR
  868. is making.  Keep in mind that a lot of data being written on the monitor
  869. will slow down the operation.  You might want to compromise between
  870. informative and efficient operation.
  871.  
  872. 5.6.1.  LEVEL OF PROGRESS REPORTING (-v, -E)
  873.  
  874. There are three levels of progress reporting.  1) TAR will inform you of
  875. every file that it processes, 2) TAR will inform you as it processes each
  876. directory, 3) TAR will not tell you anything.  You might want to choose the
  877. first option while you are installing and testing TAR and TARSHELL, then
  878. move to the second option.  If you have lots of confidence, you can then
  879. move to the third option.
  880.  
  881. 5.6.2.  PRINT RECORD NUMBERS (-R)
  882.  
  883. If set to YES, TAR will print out the record number corresponding to the
  884. beginning of each file on the tape.  This option can be very useful if you
  885. are trying to process a tape that has been damaged.  Note that this option
  886. does not take into consideration the setting of progress reporting above,
  887. so if you request record numbers and progress reporting by directory, you
  888. will see a directory name followed by a string of record numbers (one for
  889. each file), but without the file names that the record numbers correspond
  890. to.
  891.  
  892. 5.7.  CONTINUE
  893.  
  894. When you have set the file specification option the way you want it, select
  895. this option to continue the process.
  896.  
  897. TARSHELL:  The TAR Shell Program, v. 1.0                                19
  898.  
  899.  
  900. 6.  EXTRACT FROM A TAPE ARCHIVE--RANDOM (QFA) (-x -D)
  901.  
  902. This option causes TAR to read the tape archive and copy files to the file
  903. system.
  904.  
  905. 6.1.  FILE SPECIFICATION
  906.  
  907. This option allows you to specify which files are to be processed.
  908.  
  909. 6.2.  INCLUDE ONLY CERTAIN FILES (-T)
  910.  
  911. If you want to process only selected files, you may place the names of the
  912. files that you wish to process in a text file.  Only the files whose names
  913. are in the text file will be processed.
  914.  
  915. Please note:  If you specify "process only certain files" here, the file
  916. specification that you enter above will be ignored.
  917.  
  918. Also note that filenames are case sensitive and must be specified exactly
  919. as they appear in a table of contents listing.
  920.  
  921. 6.3.  FILES TO PROCESS ARE IN
  922.  
  923. This option is used in conjunction with the one above.  If you set "process
  924. only certain files" to "yes", you must provide a list of the files that you
  925. want to process.
  926.  
  927. When you select this option from the menu, you can enter the name of the
  928. file that contains the list of files that you want to process.  If you have
  929. entered the name of an editor in the configuration section above, TARSHELL
  930. will give you the opportunity to start the editor with the file that you
  931. specify so that you can enter or modify the list of filenames.
  932.  
  933. Filenames should be listed one per line. They may contain wildcards.  Also
  934. note that filenames are case sensitive and must be specified exactly as
  935. they appear in a table of contents listing.
  936.  
  937. 6.4.  EXCLUDE CERTAIN FILES (-X)
  938.  
  939. If you want to exclude certain files from processing, you may place the
  940. names of the files that you wish to exclude in a text file.
  941.  
  942. This option may be used with either the "file specification" or the
  943. "include only certain files" in effect.
  944.  
  945. Note that filenames are case sensitive and must be specified exactly as
  946. they appear in a table of contents listing.
  947.  
  948. TARSHELL:  The TAR Shell Program, v. 1.0                                20
  949.  
  950.  
  951. 6.5.  FILES TO EXCLUDE ARE IN
  952.  
  953. This option is used in conjunction with the one above.  If you set "exclude
  954. certain files" to "yes", you must provide a list of the files that you want
  955. to exclude.
  956.  
  957. When you select this option from the menu, you can enter the name of the
  958. file that contains the list of files that you want to exclude from
  959. processing.  If you have entered the name of an editor in the configuration
  960. section above, TARSHELL will give you the opportunity to start the editor
  961. with the file that you specify so that you can enter or modify the list of
  962. filenames.
  963.  
  964. Filenames should be listed one per line. They may contain wildcards.  Note
  965. that filenames are case sensitive and must be specified exactly as they
  966. appear in a table of contents listing.
  967.  
  968. 6.6.  PROCESS SUBDIRECTORIES (-Y)
  969.  
  970. Set this option to YES and TAR will process files in the subdirectories
  971. under the location that you specify in FILE SPECIFICATION above.
  972.  
  973. 6.7.  ABSOLUTE PATH/REDIRECTION (-P)
  974.  
  975. This option allows you to specify whether the files which are restored are
  976. to be copied back onto the hard disk to their original location (possibly
  977. overwriting the current file), or redirected to a different location.
  978.  
  979. 6.8.  PROGRESS REPORTING OPTIONS
  980.  
  981. Progress reporting options will keep you informed of the progress that TAR
  982. is making.  Keep in mind that a lot of data being written on the monitor
  983. will slow down the operation.  You might want to compromise between
  984. informative and efficient operation.
  985.  
  986. 6.8.1.  LEVEL OF PROGRESS REPORTING (-v, -E)
  987.  
  988. There are three levels of progress reporting.  1) TAR will inform you of
  989. every file that it processes, 2) TAR will inform you as it processes each
  990. directory, 3) TAR will not tell you anything.  You might want to choose the
  991. first option while you are installing and testing TAR and TARSHELL, then
  992. move to the second option.  If you have lots of confidence, you can then
  993. move to the third option.
  994.  
  995. 6.8.2.  PRINT RECORD NUMBERS (-R)
  996.  
  997. If set to YES, TAR will print out the record number corresponding to the
  998. beginning of each file on the tape.  This option can be very useful if you
  999. are trying to process a tape that has been damaged.  Note that this option
  1000. does not take into consideration the setting of progress reporting above,
  1001. TARSHELL:  The TAR Shell Program, v. 1.0                                21
  1002.  
  1003.  
  1004. so if you request record numbers and progress reporting by directory, you
  1005. will see a directory name followed by a string of record numbers (one for
  1006. each file), but without the file names that the record numbers correspond
  1007. to.
  1008.  
  1009. 6.9.  CONTINUE
  1010.  
  1011. When you have set the file specification option the way you want it, select
  1012. this option to continue the process.
  1013.  
  1014.  
  1015. 7.  EXTRACT FROM A TAPE ARCHIVE--SEQUENTIAL (-x)
  1016.  
  1017. This option causes TAR to read the tape archive and copy files to the file
  1018. system.
  1019.  
  1020. 7.1.  FILE SPECIFICATION
  1021.  
  1022. This option allows you to specify which files are to be processed.
  1023.  
  1024. 7.2.  INCLUDE ONLY CERTAIN FILES (-T)
  1025.  
  1026. If you want to process only selected files, you may place the names of the
  1027. files that you wish to process in a text file.  Only the files whose names
  1028. are in the text file will be processed.
  1029.  
  1030. Please note:  If you specify "process only certain files" here, the file
  1031. specification that you enter above will be ignored.
  1032.  
  1033. Also note that filenames are case sensitive and must be specified exactly
  1034. as they appear in a table of contents listing.
  1035.  
  1036. 7.3.  FILES TO PROCESS ARE IN
  1037.  
  1038. This option is used in conjunction with the one above.  If you set "process
  1039. only certain files" to "yes", you must provide a list of the files that you
  1040. want to process.
  1041.  
  1042. When you select this option from the menu, you can enter the name of the
  1043. file that contains the list of files that you want to process.  If you have
  1044. entered the name of an editor in the configuration section above, TARSHELL
  1045. will give you the opportunity to start the editor with the file that you
  1046. specify so that you can enter or modify the list of filenames.
  1047.  
  1048. Filenames should be listed one per line. They may contain wildcards.  Also
  1049. note that filenames are case sensitive and must be specified exactly as
  1050. they appear in a table of contents listing.
  1051.  
  1052. TARSHELL:  The TAR Shell Program, v. 1.0                                22
  1053.  
  1054.  
  1055. 7.4.  EXCLUDE CERTAIN FILES (-X)
  1056.  
  1057. If you want to exclude certain files from processing, you may place the
  1058. names of the files that you wish to exclude in a text file.
  1059.  
  1060. This option may be used with either the "file specification" or the
  1061. "include only certain files" in effect.
  1062.  
  1063. Note that filenames are case sensitive and must be specified exactly as
  1064. they appear in a table of contents listing.
  1065.  
  1066. 7.5.  FILES TO EXCLUDE ARE IN
  1067.  
  1068. This option is used in conjunction with the one above.  If you set "exclude
  1069. certain files" to "yes", you must provide a list of the files that you want
  1070. to exclude.
  1071.  
  1072. When you select this option from the menu, you can enter the name of the
  1073. file that contains the list of files that you want to exclude from
  1074. processing.  If you have entered the name of an editor in the configuration
  1075. section above, TARSHELL will give you the opportunity to start the editor
  1076. with the file that you specify so that you can enter or modify the list of
  1077. filenames.
  1078.  
  1079. Filenames should be listed one per line. They may contain wildcards.  Note
  1080. that filenames are case sensitive and must be specified exactly as they
  1081. appear in a table of contents listing.
  1082.  
  1083. 7.6.  PROCESS SUBDIRECTORIES (-Y)
  1084.  
  1085. Set this option to YES and TAR will process files in the subdirectories
  1086. under the location that you specify in FILE SPECIFICATION above.
  1087.  
  1088. 7.7.  ABSOLUTE PATH/REDIRECTION (-P)
  1089.  
  1090. This option allows you to specify whether the files which are restored are
  1091. to be copied back onto the hard disk to their original location (possibly
  1092. overwriting the current file), or redirected to a different location.
  1093.  
  1094. 7.8.  PROGRESS REPORTING OPTIONS
  1095.  
  1096. Progress reporting options will keep you informed of the progress that TAR
  1097. is making.  Keep in mind that a lot of data being written on the monitor
  1098. will slow down the operation.  You might want to compromise between
  1099. informative and efficient operation.
  1100.  
  1101. 7.8.1.  LEVEL OF PROGRESS REPORTING (-v, -E)
  1102.  
  1103. There are three levels of progress reporting.  1) TAR will inform you of
  1104. every file that it processes, 2) TAR will inform you as it processes each
  1105. TARSHELL:  The TAR Shell Program, v. 1.0                                23
  1106.  
  1107.  
  1108. directory, 3) TAR will not tell you anything.  You might want to choose the
  1109. first option while you are installing and testing TAR and TARSHELL, then
  1110. move to the second option.  If you have lots of confidence, you can then
  1111. move to the third option.
  1112.  
  1113. 7.8.2.  PRINT RECORD NUMBERS (-R)
  1114.  
  1115. If set to YES, TAR will print out the record number corresponding to the
  1116. beginning of each file on the tape.  This option can be very useful if you
  1117. are trying to process a tape that has been damaged.  Note that this option
  1118. does not take into consideration the setting of progress reporting above,
  1119. so if you request record numbers and progress reporting by directory, you
  1120. will see a directory name followed by a string of record numbers (one for
  1121. each file), but without the file names that the record numbers correspond
  1122. to.
  1123.  
  1124. 7.9.  CONTINUE
  1125.  
  1126. When you have set the file specification option the way you want it, select
  1127. this option to continue the process.
  1128.  
  1129.  
  1130. 8.  TAPE UTILITY FUNCTIONS
  1131.  
  1132. The functions in this menu are used to do basic tape manipulation.  These
  1133. are provided by TAPE.EXE, rather than by TAR, so they are grouped here.
  1134.  
  1135. 8.1.  RETENTION TAPE
  1136.  
  1137. This option retentions the tape.  It is a good idea to do this when using a
  1138. new tape and periodically thereafter.
  1139.  
  1140. 8.2.  REWIND TAPE
  1141.  
  1142. This option rewinds the tape to the beginning.
  1143.  
  1144.   DIAGNOSTIC:  If you request that the tape be rewound, but nothing
  1145.     happens (the tape does not move, the drive light does not come on,
  1146.     etc.), the tape may already be rewound.  Request TELL CURRENT TAPE
  1147.     POSITION below.
  1148.  
  1149. 8.3.  ERASE TAPE
  1150.  
  1151. This option erases data from the tape.
  1152.  
  1153. 8.4.  POSITION TAPE BY FILE MARK
  1154.  
  1155. This option positions the tape to a particular file by spacing over file
  1156. marks.  You will be asked how many file marks you wish to space over.
  1157. TARSHELL:  The TAR Shell Program, v. 1.0                                24
  1158.  
  1159.  
  1160. A negative number will cause the tape to space backwards.  (The use of
  1161. negative numbers is not supported on some devices.  On other devices it
  1162. works very slowly.)
  1163.  
  1164. 8.5.  POSITION TAPE BY BLOCK
  1165.  
  1166. This option positions the tape to a particular block.  You will be asked
  1167. how many blocks you wish to space over.
  1168.  
  1169. A negative number will cause the tape to space backwards.  (The use of
  1170. negative numbers is not supported on some devices.  On other devices it
  1171. works very slowly.)
  1172.  
  1173. 8.6.  POSITION TAPE TO END OF DATA
  1174.  
  1175. This option will cause the tape to be positioned after the last file on the
  1176. tape.
  1177.  
  1178. 8.7.  TELL CURRENT TAPE POSITION
  1179.  
  1180. This option will cause the TAPE program to return the block number at which
  1181. the tape is currently positioned.  (This option works only on devices which
  1182. support QFA.)
  1183.  
  1184. 8.8.  WRITE A TAPE MARK
  1185.  
  1186. This option causes TAPE to write a tape mark (end-of-file mark) on the tape
  1187. at the current position.